Amiga Collections: Tampa Bay Amiga Group/TBAG - Tampa Bay Amiga Group's Disk of the Month #67 (1992)(Merlin's Software - Amiganuts United)(PD).zip/TBAG - Tampa Bay Amiga Group's Disk of the Month #67 (1992)(Merlin's Software - Amiganuts United)(PD).adf/Docs/DWEdit.docs

Text File | 1992-04-11 | 30KB | 789 lines

DWEdit V1.51a (39664 bytes)   The configuration editor for DirWork 1.51
-----------------------------------------------------------------------

This program may be copied as long as it is accompanied by this doc file
both unaltered & no money is charged(except for a reasonable copying fee
such as what Fred Fish charges).  All use of this program is at your own
risk & I assume no responsibility or liability for any problems that occur.


    Well you can change most options/buttons etc from DirWork but
DWEdit allows you to edit some others as well as making the configuration
process a lot easier.  To start DWEdit(assuming DWEdit is in a valid path
eg c:):-

Select the "Use external configuration Editor" menu item from in DirWork
(Best way!).  Note if you do this and select Quit & Use, most changes appear
in DW immediately, but if you want those changes always you must select the
"SAVE Current Setup to a DW" menu item.

From a Shell/CLI type "DWEdit DWFileName".

From a Shell/CLI type "DWEdit s:DW.config".

    For DirWork 1.31, 1.40 - 1.50 users you can load in the previous
Button/Instant Actions and PopKey/Tool data.  Menu type Options aren't
loaded.  Things change so some coverting is done but new options might be
better so have a look.
From a Shell/CLI type "DWEdit DWFileName OldDWFileName".


    Then if everything is ok you will be presented with a screen with
all the DirWork Buttons as well as buttons for the left/middle/right mouse
button instant actions.  You can select one of the main buttons:-

Quit        - Quit without keeping any changes made.
Quit & Use    - Quit and keep changes(this appears if you run from DW).
Quit & Save    - Quit and save changes to disk(when not run from DW).
Options        - Takes you to a screen of options.
Ed PopTools    - Takes you to the PopKey/Tools screen.
Print Config    - Prints your Button/InstantAction & PopTool to PRT:.

    When the mouse is over a Button/Instant Action the current config
for that button is shown at the bottom of the display.  Pressing the button
takes you to a Button/Instant Action  editing screen.

    There are three toggle buttons on the main screen as well.  You can
select SwapButton then press buttons to swap them then select swap button
again to turn it off.  Same goes for SwapRow.  CopyBut is like swap button
but the button is copied.

----------------------------------------------------------------------------
        The Options screen
----------------------------------------------------------------------------

    Here you can change many options that you couldn't from DirWork
itself:-

OPTIONS THAT TOGGLE ON/OFF

AutoPoint    Automatically select windows the mouse is over.
        Often called SunMouse.

XCopyBootBlocks    The Boot block checker will treat Xcopy Boot blocks as if
        they are standard boot blocks.
        (ie won't warn you when you insert a disk with one)

ActivateTextGad    After getting a directory DirWork will activate the text
        gadget.

NoDWDuplicates    When you have one DW running and try to start another it
        will just bring the one running to the front.

ExternalConfig    This makes DirWork use "S:DW.config" and its
        configuration file instead of using the DW executable.
        Maybe you would like to crunch DirWork and keep changing
        your config.

ButtonsBelow    If your one of those upsidedown people this will put the
        buttons etc below the file list for you.

PositionIndepen    This make the button position irrelevent to what file list
        it refers to.  You have to press the right mouse button
        on the button to refer to the right list as the source.
        Plenty of people use DW this way as you don't have to
        have duplicates of each button.

MouseAccelerat    Accelerates your mouse based on values given in Accel and
        threshold.

NoWBenchTools    Stops DW from adding tools to the workbench screen in
        Kickstart 2.0-.

More ANSI    The text viewer can display ANSI files so if you want it
        to start in ANSI mode(its slower) select this option.

BusyPointer    A little Busy clock comes up when DW is already doing
        something.  This is on by default.

RMB Activate    This causes right mouse button presses to activate the
        DW window so you don't have to activate DW then use
        the right mouse button.

Parent Buf    If you have Buffered directories on this will
        automatically use the buffered copy of a dir if you use
        the parent/root functions on the far sides of the dir
        path gadgets.  Eg if you got the directory DF0:c then
        pressed the parent/root button it would use the buffered
        copy instead of re-reading the DF0: dir.  It will only
        use the buffered copy if you have not read other dirs
        in between.

Interlace    Screen is interlaced for DW.
        And for the text viewer.

Productivity    Screen is non interlaced.  Requires ECS chips in your
        machine and a VGA or better monitor.
        And for the text viewer.



OPTIONS YOU SET THE VALUE OF


TaskPriority    The priority relative to other prgrams running of DW.
        1 is usually a good value as it give DW more processor
        time than most other programs.
        Recommended range -5 to 5.

MouseAccel    The factor by which mouse movement will be multiplied by.
        You must turn the mouse acceleration option on as well.
        Recommended range 2 to 10.

MouseThreshhold    This is the smallest movement required before the mouse
        acceleration factor is used.  So when you do small
        movements no acceleration occurs and hence you have fine
        control. A value of 1 means always multiply be MouseAccel.
        You must turn the mouse acceleration option on as well.
        Recommended range 1 to 20.

ScreenBlankTim    Amount of time the machine must be idle before the screen
        blanks.  Assuming you have the ScreenBlank option on.
        In tenths of a second so 4800=8 minutes.
        Recommened range 2400 to 9600.

BufferedNumber    Number of directories keep in memory when you have the
        buffered directory option turned on.
        Recommened range 4 to 20.

VMKTime        Amount of time between VMK checks.  Assuming you have the
        Periodic VMK check option on.
        In tenths of a second so 80=8 seconds.
        Recommened range 10 to 180.

LeftActivate    This is the Qualifier/Keycode of the key combination that
        will activate(like you pressed the left button on gadget)
        the left directory path text gadget.  By default this is
        the Del key.

RightActivate    This is the Qualifier/Keycode of the key combination that
        will activate(like you pressed the left button on gadget)
        the right directory path text gadget.  By default this is
        the Help key.


WindowLeftEdge    The x coordinate of the top/left corner of windows DW opens
        on the workbench screen and output windows.

WindowTopEdge    The y coordinate of the top/left corner of windows DW opens
        on the workbench screen and output windows.

WindowWidth    The width of windows DW opens on the workbench screen and
        output windows.

WindowHeight    The height of windows DW opens on the workbench screen
        output windows.

ScreenWidth    The width of the screen DW opens.

ScreenHeight    The height of the screen DW opens.
        And for the text viewer.

Colors13    These are the color numbers DW uses for a window Kick 1.3.
        (0=Blue 1=White 2=Black 3=Orange by default colors)
Colors20    These are the color numbers DW uses for a window Kick 2.0.
        (0=Grey 1=Black 2=White 3=LiBlue by default colors)
ColorsSc    These are the color numbers DW uses for screen.
        They have the following sequence:-
           First three for File lists (Background/Files/Dirs)
           Next two for title bar (Text/Background)
           Next two for button text (Text/Background)
           Next one for menu/slider color
           Next two for button border

        For example Colors13 by default is:
           2133132100
        File list is  213=BlackBack/WhiteFiles/OrangeDirs
        Title bar is 31=Orange on White
        Buttons text is 32=OrangeText/Black
        Button Border is 00=No border shown

SLIDE GADGETS AT BOTTOM

    The three slide gadgets are Red/Green/Blue modifiers for the screen
palette for DW.  Just select a color button under the sliders then use the
slide movement to adjust the colors.

----------------------------------------------------------------------------
        The Button/Instant Action editing screen
----------------------------------------------------------------------------

    This screen displays the function currently selected for that
button with the main config string down the bottom and the various sections
of this config above it.  The sections that are irrelevent for the current
function are ghosted(dots across them and unselectable).  Above the config
string gadgets is information text which can be selected from three buttons
on the right hand side.

    GeneralInfo - Describes the various parts of a config string.

    SelectionInfo - Describes how selection affects a function.

    FunctionInfo - Describes the current function of the config.
                   This is selected by default.

    As well on the right hand side is a change function button which
allows you to change the button/instant action to another function.  As
with the PopTool screen a Qualifier/Keycode box is on the right.  You can
see what values a reuired for a button to be activated by a certain key
combination by clicking on this box and presing the keys you want.


The button configuration is a single string consisting of:-
------------------------------------------------------------------
'BName,FSOQuCo,Arguments'
 ||||| |||\__/||
 |     ||| |  |+- Arguments for operation.
 |     ||| |  +--- Special option for certain routines
 |     ||| +------- Keyboard combination (qualifier/keycode)
 |     ||+----------- Options for certain routines.
 |     |+--------------- What needs to be selected to operate.
 |     +----------------- Internal function the button uses.
 +-Button Name of 5 Chars
   In the case of instant actions this text can describe filetype.
------------------------------------------------------------------

    Selection is only relevent to lower case functions as these are the
only ones which deal with files(s)/dir(s) in the file lists.  For the lower
case functions 'F' means apply function on all selected files, 'D' all
selected dirs and 'B' all selected files and all selected dirs.  'A' all
files and dirs even if they are not selected.  Another option is 'f' which
will apply the function to all selected files but if there are no files
seleted it will apply the function with no filename.  'f' is great for
creating buttons like Edit so that you can edit a selected file and if you
want to create a new file just hit the Edit button with no files selected.

NOTE: Press return after any change in any text gadgets on this screen
      otherwise your changes may not be registered.

    Ok so say you wanted to change the "DH0:  " button to "DF2:  " you
would select that button from the main DWEdit screen then you would see
that in the arguments is "DH0:" so click in that text gadget change it to
"DF2:" then press return.  Now that button will read "DF2:" but you will
also want to change the button text so click in that text gadget and change
it to "DF2:  " note that it must be 5 characters no more no less.  Press
Quit & USe or Quit & Save and you will see the button now has a new Button
text and when you pres it reads the new directory("DF2").

    Plenty of functions have options which a described in the Function
Info text.  If you wanted the show button to show icons as well all you
would do is go to DWEdit's main screen select the show button.  Then you
will see the text saying that you must change the option to i to get the
show function to display icons as well as IFF pictures.  So click in the
Option gadget change the 0 to i and it is done.

    Maybe you want a button to relabel disks.  In DWEdit's main screen
just click on the button that you want to be relabel.  Then the current
config for that button comes up.  Ignore that and press the change function
button on the right hand side of the screen.  Now you get a display of all
the available functions in DW, press the L function button which says
relabels disks or simialr.  Now you are back to the config screen and the
default config function has been entered in the button config.

    Ok say you want to change the instant action for double clicking on
a text file to use a external viewer.  In DWEdit's main screen click on the
Text button for left mouse instant actions.  Now the button is using
function t (inbuilt text viewer function) but you want to use an external
program so select change function button on right hand side of display and
you will see the many available functions, you will see the function u with
a description that it runs external programs so select it.  Then its back
to the button config screen in which you must change the Buttontext back to
what it was as instant actions need the Button text to remain the same and
all you have to do is change the arguments to run you external program
which could be something like "Run >NIL:  MuchMore" or similar.  Note it
might have been quicker if you knew u was the function you where after as
you would have skipped the change function button stuff and manually
entered the u into the function text gadget and avoided having to change
the Buttontext back to what it was.


    Well they are simple examples of changes you can do very powerful
changes to run external programs cd directorys open windows and flip
between screens.  See the SAMPLE CHANGES section for other examples.


    If you want to create a new instant action type say you have
certain files that end in ".pcd".  You must replace one of the current ones
and change all three Button text's (Left, Middle & Right) to ".pcd ".  But
do NOT change ILBM, 8SVX, ANIM, SMUS, FTXT, Most, PP, Exec, Text, .GIF as
they are not only recognised by filename.

SAMPLE CHANGES FOR BUTTONS/INSTANT ACTIONS:-

---------------------------------------------------------------------------
Routine| Example changes and Information
letter | Remember upper case routine letter means selected file(s) related.
---------------------------------------------------------------------------
D    A simple change would be changing DH1: to DF2: and make the F1 key
    get that directory.  Just select the DH1: button, go up to change
    last button pressed and change
    " DH1:,D00----,DH1:" to " DF2:,D000050,DF2:".

    To make a button that gets the directory already in the text gadget
    (instead of just pressing the right mouse button over the gadget)
    "GetDr,D0c----,"

N    Executes commands. Use this function if you want to execute a program
    and don't want the selected files to be added to the command.
    You must add CTRL-J EndCLI to your command if you use a option
    that opens a window(w,W,p,P) and you want it to automatically close.

    Options(w,W,p,P,f,F,t,T,R,0):-

       Uppercase of any of these letters means a requester first.

       w if you want a window to open for the output.
       p if you want a window to open for the output and waits for you
         to press a key before it closes.
       f bring default public screen(usually workbench) to the front.
       t bring default public screen(usually workbench) to front for
         command then DW screen.

       R if you want a requester so you can edit the command before
         it is executed.
       0 means no window or requester or bringing screens to the front.

    SpecialOp(s,d,',')

       s CD source directory before command then refetch that dir
         after.
       d CD destination directory before command then refetch that
         dir after.
       , as normal do no CD'ing.

    Examples:-

    "Prefs,N00----,Preferences"  Bring up 1.2/1.3 preferences.
                             No output window is opened.

    "Paint,N00----,Run >NIL: Paint"  Start a paint program but
                                     allow DW to continue.

    "Avail,N0p----,AvailJEndCLI"   Show available memory in a window.
                               Then automatically close that window
                               after the user presses a key (or clicks
                               on the close gadget with Kick2.0+).
                                   Note the J is CTRL-J

    "Avail,N0w----,List"   List a directory in a output window that stays
                       open until the user enters EndCLI (or clicks
                       on the close gadget with Kick2.0+).

    "DiskC,N0w----,DiskCopy DF0: TO DF0:JEndCLI"  Diskcopy DF0: to DF0:
                                              opening a window for
                                              the output that auto
                                              closes when the Diskcopy
                                              is finished.
                                                  Note the J is CTRL-J

M    The Makedir function can be given a filename which it will copy
    to create a icon for the directory.  All you have to do is give
    it the filename of the icon you want it to create.
    "MakDr,M00----,sys:DefaultDraw.info"


P    To create a parent button if you don't like going to the far
    left/right of the directory text and pressing the left button.
    "Paren,P00----,"

R    To create a root button if you don't like going to the far
    left/right of the directory text and pressing the right button.
    "Root ,R00----,"


t    Is the Type/Hextype function.  Options are
    A=ASCII H=Hex (try to load full file)
    a=ASCII h=Hex (Only load first 32K of file)

j    Options(f,F,d,D,b,B,p,P) Uppercase=DeSelect LowerCase=Select
    To make a button select dirs as well as files.
    "All  ,jAb----,"
    To make a button select all dirs.
    "AllDr,jAd----,"
    To make a button deselect all dirs.
    "NoDir,jAD----,"
    To make a button that request you for a pattern that deselects
    "PtDSl,jAP----,"

s    To make a show button display icons as well as IFF pictures.
    "Show ,sFi----,"

k    Options(c,C,t,T,s,S) Uppercase requester user can edit first
    t=toggle protection s=setprotection c=set comment
    The Protect function inverses the protect bit specified in the
    So "Prote,kBt----,d" will change the delete protection of a file.

    "PNorm,kBs----,rwed" would set all files/dirs to normal protection.

    "SetCm,kFs----,DW Rules!" would set all files comments to DW Rules!

    "ClrCm,kDS----," would request user for comment then set all dirs
                     comments to it.


d    To make a delete button that doesn't request you when you delete a
    non empty dir.
    Options (d,D,b,B)
    "Delet,dB0----,"
    A delete button that requests you when you delete a file
    or a directory:-
    "Delet,dBB----,"
    The lower case letter option means that if Delete fails it will
    prompt you and if you want will UnProtect each file and try to
    delete again.

c    Options (c,D,C)
    To make a copy button clone the file note, protection and date.
    BytesFree for the source/destination is updated after a copy.
    "CCopy,cBc----,"
    To make a CopyAs button that clones
    "CCpAs,cBC----,"
    To make a CopyAs button that doesn't clone
    "CCpAs,cBD----,"
    To make a Copy button that doesn't clone
    "CCpAs,cB0----,"

m    To make a move button clone the file note, protection and date.
    "CMove,mBc----,"

u    The u internal routine is one of the most usefull it will execute
    the text in the argument part of the button config with any any
    file/dirnames selected.  If you want the button to operate on
    selected files and directories use the B middle letter.  If you
    want it just to operate on selected files use F and if you just
    want it to operate only on selected Dirs use D.  There is another
    selection that is usefull for this function, 'f' will execute the
    command with all selected files but if there are none selected
    it executes the command with no filename.  Note the u command
    automatically adds JEndCLI (where J is CTRL-J) to commands
    that use an option that opens a window(w,W,p,P).

    Options(w,W,p,P,f,F,t,T,R):-

       Uppercase of any of these letters means a requester first.

       w if you want a window to open for the output.
       p if you want a window to open for the output and waits for you
         to press a key before it closes.
       f bring default public screen(usually workbench) to the front.
       t bring default public screen(usually workbench) to front for
         command then DW screen.

       R if you want a requester so you can edit the command before
         it is executed.
       0 means no window or requester or bringing screens to the front.

    SpecialOp(s,d,',')

       s CD source directory before command then refetch that dir
         after.
       d CD destination directory before command then refetch that
         dir after.
       , as normal do no CD'ing.

    An example of using the u routine is the edit button and right mouse
    instant operation on text files:- " Edit,uF0----,Run >NIL: E"
    To change to path for the editor from E to c:Ed just select the edit
    button, go up to change last button pressed and change to
    " Edit,uF0----,Run >NIL: c:Ed"
    Note an output window is not needed hence the 0 as the option.
    But it is even better to use the f selection with a edit button
    as then you you select no files the editor is still executed and
    you can use that method to create a new file for editing.

    To change the double click on a text file to use another text viewer
    instead of the default internal type.  After you double click a
    text file & select change last button pressed
        "Text ,uF0,Run >NIL: ViewerName". eg "Text ,uF0,Run >NIL: MuchMore"

    To make a button that uses DOS's list command on selected files and
    dirs, and shows the output in a window than stays open until the
    user presses a key (or clicks the close gadget with Kick2.0-).
    "List ,uBp----,List"

    To make a button that uses DOS's Execute command to execute script
    files, with an output window open while the command is executing.
    "Execu,uFw----,Execute"

    To make a button that uses DOS's FileNote command to change the
    FileNote of a file in a requester.
    "Execu,uFR----,FileNote"

    To make a button that extracts files to the same directory then
    gets DW to re-read that directory, displaying the output from
    the program in a window that automatically closes
    ".LZH ,uFw----sLZ x"


a    The a function is very similar to the u function except that it
    adds "/*" to directory names and has its own output window so
    there is no need to use an option to open one.


b    Is the routine which displays the FileNote/protection bits so
    "FBits,bB0----," would create a button for it instead of going to the
    far right or left of the file/dir.




Here is the default configuration of DW:-

"Instn,nF0----,",
"Print,ifP----,",
"Serch,fF0----,",
"LZ A ,aB0----dLZ -r -x a ",
"NewZP,uff----,Run >NIL: NewZAP",
"CpyAs,cBD----,",
"Info ,I00----,",
" Info,I00----,",
"DskOp,K00----,",
"NewZP,uff----,Run >NIL: NewZAP",
"Commd,N0w----,",
"NewSh,N0f----,NewShell",
"AdIcn,wB0----,",
"Sleep,S00----,",

"EScpt,uFw----,Execute",
"Prote,kBt----,d",
"PlayS,pF0----,",
"MakDi,M00----,",
"HxTyp,tFH----,",
"Delet,dBd----,",
"Move ,mB0----,",
" Move,mB0----,",
"Delet,dBd----,",
"HxTyp,tFH----,",
"MakDi,M00----,",
"PlayS,pF0----,",
"Prote,kBt----,d",
" VMK ,V00----,",

"PatSe,jAp----,",
" Run ,ufR----,Run >NIL:",
"Show ,sF0----,",
"Edit ,uf0----,Run >NIL: E",
"Type ,tFA----,",
"Renam,rB0----,",
"Copy ,cB0----,",
" Copy,cB0----,",
"Renam,rB0----,",
" Type,tFA----,",
" Edit,uf0----,Run >NIL: E",
" Show,sF0----,",
" Run ,ufR----,Run >NIL:",
"PatSe,jAp----,",

"WORK:,D00----,WORK:",
"SYS: ,D00----,SYS:",
"DH1: ,D00----,DH1:",
"DH0: ,D00----,DH0:",
"DF1: ,D00----,DF1:",
"DF0: ,D00----,DF0:",
"RAM: ,D00----,RAM:",
" RAM:,D00----,RAM:",
" DF0:,D00----,DF0:",
" DF1:,D00----,DF1:",
" DH0:,D00----,DH0:",
" DH1:,D00----,DH1:",
" SYS:,D00----,SYS:",
"WORK:,D00----,WORK:",

Small buttons:-

"All  ,jAf----,",
"None ,jBB----,",
"CD   ,C00----,",
"<<   ,E00----,",
"<>SWA,W00----,",
">>   ,E00----,",
"CD   ,C00----,",
"None ,jBB----,",
"All  ,jAf----,",

Left double click instant actions:-

"MOD. ,uFf----,Intuitracker",
".ARC ,uFp----,Arc v",
".DMS ,uFW----,DMS Write",
".LZH ,uFp----,LZ l",
".LHW ,uFW----,Lhwarp Write 0",
".PAK ,uFw----d",
".WRP ,uFW----,UnWarp",
".ZIP ,uFp----,UnZIP -v",
".ZOO ,uFp----,Zoo v",
".GIF ,uF0----,VirtGIF",
".INFO,sFi----,",
".8SVX,pF0----,",
".ANIM,uF0----,ShowANIM",
".ILBM,sF0----,",
".SMUS,uF0----,PlaySMUS",
".FTXT,uF0----,",
".Most,uFt----,Most",
".PP  ,tFA----,",
".Exec,000----,",
".Text,tFA----,",
"Binry,tFH----,",
".LHA ,uFp----,LZ l",
".uue ,tFA----,",
".jpg ,uF0----,Run >NIL: JView",

Middle click instant actions:-

"MOD. ,uFf----,Run >NIL: Intuitracker",
".ARC ,uF0----dRun >NIL: Arc xw",
".DMS ,uF0----,Run >NIL: DMS Write",
".LZH ,uF0----dRun >NIL: LZ -m -x -r x",
".LHW ,uF0----,Run >NIL: Lhwarp Write 0",
".PAK ,uF0----dRun >NIL:",
".WRP ,uF0----,Run >NIL: UnWarp",
".ZIP ,uF0----dRun >NIL: UnZIP -xdo",
".ZOO ,uF0----dRun >NIL: Zoo xO//",
".GIF ,uF0----,Run >NIL: VirtGIF",
".INFO,sFi----,",
".8SVX,uF0----,Run >NIL: PlaySS",
".ANIM,uF0----,Run >NIL: ShowANIM",
".ILBM,uF0----,Run >NIL: Dpaint",
".SMUS,uF0----,Run >NIL: PlaySMUS",
".FTXT,uF0----,",
".Most,uFf----,Run >NIL: Most",
".PP  ,uF0----,Run >NIL: PowerPacker",
".Exec,uF0----,Run >NIL: ReSource",
".Text,uF0----,Run >NIL: E",
"Binry,uFf----,Run >NIL: NewZAP",
".LHA ,uFw----dRun >NIL: LZ -m -x -r x",
".uue ,uF0----dRun >NIL: uudecode",
".jpg ,uF0----,Run >NIL: JView",

Right click instant actions:-

"MOD. ,uFf----,Run >NIL: Intuitracker",
".ARC ,uFw----dArc xw",
".DMS ,uFW----,DMS Write",
".LZH ,uFw----dLZ -m -x -r x",
".LHW ,uFW----,Lhwarp Write 0",
".PAK ,uFw----d",
".WRP ,uFR----,Run >NIL: UnWarp",
".ZIP ,uFw----dUnZIP -xdo",
".ZOO ,uFw----dZoo xO//",
".GIF ,uF0----,Run >NIL: VirtGIF",
".INFO,uFf----,Run >NIL: IconEdit",
".8SVX,uF0----,PlaySS",
".ANIM,uF0----,ShowANIM",
".ILBM,uF0----,Mostra",
".SMUS,uF0----,PlaySMUS",
".FTXT,uF0----,",
".Most,uFf----,Run >NIL: Most",
".PP  ,uF0----,PPShow",
".Exec,uFR----,",
".Text,uF0----,Run >NIL: E",
"Binry,uFf----,Run >NIL: NewZAP",
".LHA ,uFw----dLZ -m -x -r x",
".uue ,uFw----duudecode",
".jpg ,uF0----,Run >NIL: JView",


----------------------------------------------------------------------------
        The PopKey/Tools editing screen
----------------------------------------------------------------------------

    There is a slight difference between Button/Instant Actions and the
PopKey/Tool configuration as the PopKey entry has no button name part and
has @ at the start of each entry other wise they are the same.

         "@       ,       "
           |||\__/||
           ||| |  |+---------Arguments for operation.
           ||| |  |          Also what appears as menu text.
           ||| |  |          Must have something here for PopKey/Tools
           ||| |  +-------------Special options
           ||| +------  Keyboard combination (qualifier/keycode)
           |||
           |||
           |||+-------------- Options for certain routines.
           ||
           ||
           |+--------------- What needs to be selected to operate.
           |    F=Selected Files. D=Selected Dirs.
           |    B=Selected Files &/or Dirs.
           |    A=All files/dirs even if not selected.
           |    f=special mode that allows some files or no files
           |    0=irrelevent (This is usually the case for PopKey/Tools
           |
           +--------------- Internal routine the button uses.
                     A capital letter signifies that the operation does
                     not require selected files/dirs.  A lower case
                     hence means the operation should require selected
                     files/dirs.


    So say you wanted to change the PopKey to wake up DirWork all you
have to do is edit the Qualifier/KeyCode of the first entry.  First click
out of the text gadget the press the key combination you want DirWork to
wake up with.  The values for this key combination is shown on the right
hand side of the display.  Just substitue those values for the one
currently in the PopKey/Tool text gadget.

By pressing the * on the keypad you would have got Qual=00 & Key=5D :-

So "@A001922,DW in Memory" becomes "@A00005D,DW in Memory"
     \_/\/\/
      |  \ + The D KeyCode
      |   + The CTRL SHIFT ALT Qualifier
      + Remember this is the function part A just happes to be awake function


    The most common thing you will add to you tools/popkey data are
commands to execute external programs so an example is to make it so if we
select "Paint" from the Tools menu or press Amiga-F2

So add to the PopKey/ToolData "@N004051,Run >NIL: Paint".

The N means execute external program, the first 0 means nothing needs to be
selected in the file lists and the second means no options.  Then the next
4 numbers are the Quailfier/Keycode for LeftAmiga-F2 key combinations.
Then After the , is the command to execute and this is the text that will
show in the tools menu.

For more information on the N function (or any other as you can use all
the functions that you can use to define a button, the captial letter
functions are the ones you might use though) see the Button/Instant Action
section.

----------------------------------------------------------------------------
    General details
----------------------------------------------------------------------------

For each button and PopKeyEntry you can specify a key combination consisting
of special keys (Qualifiers) and the normal key.  Here are some values to
help you.  But in DWEdit on the Button change screen and the PopKey/Tool
screen you can just click out of any text gadget and the press any key
combination and the values are displayed.

    Sample Qualifiers:    Sample RawKeys:
       LSHIFT=$01        Esc=$45   F1=$50 to F10=$59
       RSHIFT=$02          `=$00    1=$01 to   \=$0D    BS=$41
       CTRL  =$08        Tab=$42    Q=$10 to   P=$19 to  ]=$1B
       LALT  =$10                   A=$20 to   L=$28 to  '=$2A
       RALT  =$20                   Z=$31 to   M=$37 to  /=$3A
       LAMIGA=$40        Del=$46  Help=$5F  Return=$44 Space=$40
       RAMIGA=$80        Up=$4C Down=$4D Left=$4F Right=$4E

                    Keypad RawKeys:

                (=$5A to *=$5D   -=$4A     +=$
                0=$0F    .=$3C   Enter=$43


History:    V1.41a    First release
        V1.42a    Now loads the PopKey/Tools from 1.40 DW's
            And some help/example text improvements.
        V1.43a    Added CopyBut and more examples.
        V1.50a    Added options.
            Major improvement to button/instant action editing.
        V1.51a

Bye,
    Chris Hames (Available for Amiga programming work)